3D Graphics Programming with QuickDraw 3D 1.5.4

Attaching Data to a Viewer

This section describes the routines you can use to attach data to viewer objects.

Q3ViewerUseFile

You can use the Q3ViewerUseFile function to set the file containing the 3D model to be displayed in a viewer object.

MAC OS VERSION



 
OSErr Q3ViewerUseFile (

                     TQ3ViewerObject    theViewer,

                     long               refNum);

WINDOWS VERSION



 
TQ3Status Q3WinViewerUseFile (

                     TQ3ViewerObject    viewer,

                     HANDLE             fileHandle );

PARAMETERS

theViewer: A viewer object.
refNum: The file reference number of an open file.
fileHandle: A handle to an open file.

DESCRIPTION

The Q3ViewerUseFile function sets the 3D data file to be displayed in the viewer object specified by the theViewer parameter to the open file having the file reference number specified by the refnum parameter.

Q3ViewerUseData

You can use the Q3ViewerUseData function to set the memory-based data displayed in a viewer object.

MAC OS VERSION



 
OSErr Q3ViewerUseData (

                     TQ3ViewerObject    theViewer,

                     void               *data,

                     long               size);

WINDOWS VERSION



 
TQ3Status Q3WinViewerUseData (

                     TQ3ViewerObject    viewer,

                     void               *data,

                     unsigned long      size );

PARAMETERS

theViewer: A viewer object.
data: A pointer to the beginning of a block of data in memory.
size: The size, in bytes, of the specified block of data.

DESCRIPTION

The Q3ViewerUseData function sets the 3D data to be displayed in the viewer object specified by the theViewer parameter to the data block beginning at the address specified by the data parameter and having the size specified by the size parameter.